脚本作者Lisztdreams
联系方式：5Mods账号ID：Lisztdreams
                  QQ邮箱757946163@qq.com
                  哔哩哔哩uid：452301387
脚本更新时间：2026.05.30
(未经过作者同意 禁止修改以及打包传播和售卖)

------------------脚本基本介绍---------------------
PersonalVehicleSaver - 个人载具保存与追踪脚本
让您的爱车永不丢失，实现真正的“私人车库”体验。

（作者注：因为我本人一直在使用类似功能的脚本，但很遗憾的是，这些脚本中要么无法正确保存内饰颜色，要么就是无法保存汽车改装件，几乎没有一款能够完整保存所有载具参数。所以我决定自己动手，做一个能够完整保存绝大部分载具相关参数的脚本，让每一次还原都近乎完美。）

这是一个完全独立的 .dll 脚本，允许您将当前驾驶的车辆一键保存至本地文件，并在游戏世界中生成可追踪的地图标记（Blip）。无论您身处何处，保存的车辆都会在您接近时自动生成，远离时自动回收，彻底告别车辆丢失的烦恼。

【必需插件】
本脚本基于 ScriptHookVDotNet 开发，运行前请确保已正确安装以下依赖：
ScriptHookV (http://www.dev-c.com/gta5/scripthookv)
dinput8.dll（随 ScriptHookV 一同提供）
ScriptHookVDotNet v3.7.0-nightly.78 或更高版本 (https://github.com/scripthookvdotnet/scripthookvdotnet-nightly/releases)
.NET Framework 4.8 或更高版本

【核心功能】
一键保存 / 移除车辆
默认组合键：Space（空格）+ K
坐在目标车辆中同时按下这两个键，即可将该车辆注册为您的“个人载具”。
再次在同一车辆上按下相同组合键，会删除保存文件并移除追踪状态，车辆将不再自动生成。

自动生成与回收
生成距离：当您靠近保存车辆的位置（默认 150 米）时，车辆会自动重新生成并恢复其所有改装、颜色、涂装等属性。
回收距离：当您远离车辆超过 300 米 时，车辆会自动删除（节省游戏性能）。
每个游戏帧最多生成 1 辆 载具，避免性能骤降。

不同的载具类型，不同的地图图标
脚本会根据车辆的实际类型自动分配对应的地图标记图标，让您一眼就能区分：
跑车 / 超级跑车 → 标准车辆图标
摩托车 → 摩托车专用图标
飞机 → 飞机图标
直升机 → 直升机图标
船 → 船只图标
服务车辆 / 紧急车辆 → 特殊服务图标

车牌与地图标记颜色
每辆保存的车辆都会在保存时的坐标生成一个彩色地图标记。
标记颜色根据主角自动变化：
富兰克林 → 绿色
麦克 → 蓝色
崔佛 → 橙色
其他角色 → 金色
当您驾驶自己的保存车辆时，对应的地图标记会临时隐藏，下车或换车后恢复显示。

车辆状态完全保存
脚本会存储以下所有属性，确保还原度接近 100%：
主色、副色、珠光色、轮毂色、装饰色、仪表板色
所有改装件（引擎、涡轮、悬挂、刹车、保险杠、排气管等，共 48 项）
轮胎烟雾颜色、氮气颜色、霓虹灯状态与颜色
玻璃颜色、车牌样式、车牌号码
涂装、轮毂类型、前后轮个性化设置
氙气灯及其颜色、涡轮增压、防爆轮胎
附加部件（Extras 1-10）、敞篷车顶状态

车辆位置实时更新
当您驾驶已保存的车辆并离开它之后，脚本会自动将车辆的最新位置和最新改装写入保存文件，这意味着您随时可以将爱车停到新位置，即使下次进入游戏时它也会从最后下车的位置生成。不会导致在初始保存位置再次生成一辆一模一样的车辆

【配置文件说明 (VehicleSaver.ini)】
首次运行脚本后，会在 scripts/SavedVehicles/ 文件夹下自动生成 VehicleSaver.ini，您可根据喜好修改。
ini
[Settings]
; 保存/移除车辆的组合键（两个键的虚拟键码，用逗号分隔）
; 默认 32=空格, 75=K
SaveKey=32,75

; 是否显示已保存车辆的地图标记（true/false）
ShowBlips=true
如何自定义按键？
虚拟键码参考：Space=32，K=75，L=76，G=71，F5=116 等。
修改后保存文件，重新加载脚本或重启游戏生效。

【安装与使用】
将 PersonalVehicleSaver.dll 放入您的 scripts 文件夹（如果没有请手动创建）。
启动游戏，脚本会自动创建 SavedVehicles 文件夹和 VehicleSaver.ini。
坐上您想要保存的任何车辆，同时按下 Space + K（或您自定义的组合键）。
屏幕左上角会显示 [车牌号] registered as personal vehicle.
车辆位置会出现一个彩色地图标记（图标会根据车型自动匹配）。
想要移除该车辆：再次坐上同一辆车，按下相同的组合键。
屏幕提示 [车牌号] unregistered.
地图标记消失，保存文件被删除。
保存的车辆文件（.sav）位于 scripts/SavedVehicles/ 中，您可以手动备份或分享给其他玩家（需要对方也安装此脚本或者载具模型）。

【高级特性】
持久性保证
已保存的车辆会被标记为“任务实体”（Mission Entity）并设置为持久存在，即使您切换角色、传送或离开很远，再次靠近时仍然会正确生成。
多车辆独立追踪
您可以保存任意数量的车辆，脚本会为每辆车单独创建文件与标记。当接近任一保存位置时，对应的车辆都会自动生成。

【注意事项】
如果手动删除了 .sav 文件，载具将会在下一次重启游戏进入后消失。
请不要同时使用其他类似的车辆保存脚本，以免产生冲突。
被保存的车辆不会被系统自动清除，请放心。

【更新日志】
v1.0.0（初始版本）
实现基础保存 / 删除功能
使用玩家与保存的载具距离生成/删除的机制 以此优化脚本性能（防止保存的载具在整张地图上过多时导致的卡顿）
完整保存车辆所有改装和颜色属性
动态地图标记，驾驶时自动隐藏
可配置组合键与 Blip 开关
自动更新保存位置，载具更新内容
根据载具类型自动分配不同的地图图标（跑车/摩托/飞机/直升机/船/服务车辆）

v1.1.0
修复了重启游戏后载具无法加载的问题
添加了详细的日志文件 VehicleSaver_Log.txt 以便于问题排查
优化了存档文件的解析性能

v1.1.1
延长加载等待时间至5秒
增加等待状态日志便于排查加载失败原因

v1.1.2
解决了因系统区域设置导致车辆重启后出现在随机位置的问题
将加载等待时间延长至5秒 提升在慢速电脑或大量MOD环境下的加载成功率
注意:更新后请删除SavedVehicles文件夹内所有旧sav 文件（旧格式不兼容），使用新版本重新保存车辆即可